home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Best of Shareware
/
Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso
/
mac
/
DOS
/
UTILITY
/
WRAP10
/
DEBUGNXT.DOC
< prev
next >
Wrap
Text File
|
1992-09-01
|
6KB
|
160 lines
================================================================================
DEBUGNXT.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
DEBUGN86.SYS (8086): Ver. 1.0, Copyright (1992) by Philip B. Gardner
================================================================================
DEBUGNXT.SYS is a companion device driver to WRAPPER.SYS which enables
debugging of the intialization phase of device drivers. It complements
WRAPPER's special support for loading debuggers, but may also be used
independently of WRAPPER. DEBUGNXT triggers the debug interrupt (INT 03)
in such away as to trap a debugger at the first instruction of the
the next device following DEBUGNXT in CONFIG.SYS. DEBUGNXT will operate
only once for each instance that it is loaded, but may be loaded multiple
times in the CONFIG.SYS file. High memory users may load WRAPPER and/or
DEBUGNXT into high memory with a device loader, or using MS-DOS 5.0's
DEVICEHIGH command.
================================================================================
(Requirements)::
* 186 processor or better (WRAPP86.SYS and DEBUGN86.SYS are
included to support 8086/8088 processors)
* Requires MS-DOS Version 3.1 or better
================================================================================
(Installation)::
(CONFIG.SYS)::
Install DEBUGNXT.SYS in your CONFIG.SYS as a DEVICE
DEVICE=DEBUGNXT.SYS [options]
An example of how to use DEBUGNXT.SYS to debug MYDEVICE.SYS follows.
The debugger is MS-DOS's DEBUG (loaded by WRAPPER).
DEVICE=WRAPPER.SYS /C-/D/M32 C:\DEBUG.EXE
DEVICE=DEBUGNXT.SYS
DEVICE=MYDEVICE.SYS
(Display at boot-up):
WRAPPER.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
: User interrupt 60h hooked
(Debug's prompt):
-a 100 ; assemble at 0100
1234:0100 int 60 ; the instruction "int 60"
-g ; go
DEBUGNXT.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
(Stops at first instruction of MYDEVICE's strategy routine):
AX=0000 BX=03E6 CX=0000 DX=0000 SP=05A6 BP=0000 SI=0000 DI=0000
DS=0C96 ES=9087 SS=9087 CS=0C96 IP=0016 NV UP EI PL NZ NA PO NC
0C96:0016 2E CS:
0C96:0017 891E1200 MOV [0012],BX CS:0012=0000
-
All switch options and possible messages for DEBUGNXT are detailed
below:
================================================================================
(Syntax)::
The only thing to remember about syntax for the command line is
that just about anything works. What this means is that you
should be able to type in the options on the command line the
way they make sense to you.
To illustrate this point, the following command line example
is mutated several different ways.
DEVICE=DEBUGNXT.SYS /R- /P-
DEVICE=DEBUGNXT.SYS -R- -P-
DEVICE=DEBUGNXT.SYS -R--P-
... and so on.
(Switch Options)::
(REPORT):: R[+ or -] (toggle: default +)
Use /R- to disable messages from WRAPPER.SYS.
(PAUSE):: P[+ or -] (toggle: default +)
Use /P+ to enable the pause after the any report messages.
(NOPAUSE):: N[+ or -] (toggle: default -)
Use /N+ to never pause after the report, even if there
are errors. This switch can be used if your configuration
generates a warning or error message which you choose to ignore.
* everything in square brackets "[]" is optional
(CONFIG.SYS Line)::
DEVICE=DEBUGNXT.SYS [/R-][/P+][/N-]
device default: /R+/P-/N-
* Report status messages
* Don't Pause after report
* Pause on errors or warnings
================================================================================
(Report Format)::
DEBUGNXT.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
ERROR : (Error Messages)
WARNING : (Warning Messages)
ADVICE : (Advisory Messages)
: (Report Messages)
: (Allocation Status)
PAUSE : Press any key to continue...
================================================================================
(Error Messages)::
MS-DOS version 3.10 or above is required
DOS version is not compatible
An 80186 processor or better is required
Bad or missing program specification
User Interrupts 60h - 67h are in use
================================================================================
(Warning Messages)::
Unknown option in command line
Extra characters on command line
================================================================================
(Advisory Messages)::
================================================================================
(Report Messages)::
User interrupt 00h hooked
Invalid Parameter for /D 00
================================================================================
(Allocation Status)::
================================================================================
(Changes)::
================================================================================